home *** CD-ROM | disk | FTP | other *** search
/ Night Owl 6 / Night Owl's Shareware - PDSI-006 - Night Owl Corp (1990).iso / 015a / srch104.zip / READ14.ME next >
Text File  |  1992-01-07  |  13KB  |  345 lines
  1. SRCH104.EXE
  2. COPYRIGHT 1991: MILES PAWSKI
  3.  
  4.  
  5. SRCH14.ZIP CONTAINS:
  6.  
  7. SRCH104.EXE      ---      Command Line Utility
  8. SRCH104P.EXE     ---      Application Program
  9. READ14.ME        ---      Info file
  10.  
  11.  
  12. (Uploaded by author)
  13.  
  14.  
  15.  
  16.  
  17. NOTE: This utility replaces SRCH100.EXE, SRCH101.EXE, SRCH102.EXE
  18.       and SRCH103.EXE
  19.  
  20.  
  21.  
  22.  
  23.            ------------- SRCH104.EXE -----------
  24.  
  25.                     COMMAND LINE UTILITY
  26.  
  27.  
  28. SRCH104.EXE is a text search utility that searches ALL files,
  29. regardless of their type, for text.  If text is found, a line fragment
  30. (70 characters maximum) will be displayed which contains the text and
  31. the matching text will now be highlighted.  You can now scroll forward
  32. and backward through files by the use of the new -tp (t) parameter.
  33. You can also recurse through subdirectories with the new -r parameter.
  34. You may quit the program at any time by just pressing ESC.
  35.  
  36.  
  37. This program filters out control characters for display.  Control
  38. characters (ascii 1 to 29) can be searched for but they will not be
  39. displayed (although the line fragment which contains them will be).
  40. All other characters will be displayed.
  41.  
  42. This program is fast, can easily be used in batch files and is much
  43. better than the DOS FIND utility.
  44.  
  45.  
  46. SRCH104P.EXE is an actual application program if the command line
  47. version doesn't appeal to you.  It has all the same features and is
  48. very easy to use.
  49.  
  50.                        --------------------
  51.  
  52.  
  53. FORMAT: SRCH104 [-]FILENAME "TEXT" [-r] [-12345] [-p] [-tp] [(/)/d:\x]
  54.  
  55. Parameters in brackets are optional.
  56.  
  57. FILENAME is the FULL PATH NAME of the file in which you want to search
  58. for text.  It must be a full path, e.g.: a:\*.*  (drive, directory,
  59. etc.), even if you want to search the directory in which you are in at
  60. the time.  It must come after SRCH104 and have a space before and after
  61. it.  DOS WILDCARDS ARE ALLOWED and may be used within DOS conventions,
  62. e.g.: c:\*.*  FILENAME can now be on any drive that you wish.
  63.  
  64. FILENAME may be replaced by a search file which contains the names of
  65. files and directories that you want searched.  It should be written on
  66. a pure ASCII editor and contain one file\directory per line and follow
  67. standard DOS file naming conventions, e.g:
  68.  
  69. The file search.dat contains the four lines:
  70.  
  71. c:\hold\*.bas
  72. c:\dos\*.com
  73. c:\*.*
  74. a:\utility\bigfile
  75.  
  76. All .bas files in the "hold" directory, all .com files in the "dos"
  77. directory, all files in the "root" directory, and the file "bigfile" in
  78. the "utility" directory on the A drive will be searched.
  79.  
  80. The SEARCHFILE must be delimited by a hyphen and contain the full path
  81. of the file e.g.: SRCH104 -c:\search.dat "Anytext".....
  82.  
  83.  
  84.  
  85. "TEXT" is the text word or phrase or letter that you want to search
  86. for.  It MUST be surrounded by QUOTATION MARKS.  This program will
  87. report back word fragments as well as whole words.  For example "the"
  88. will display not only the word "the" but all words containing "the"
  89. such as "there", "them", etc.  To search for whole words, simply add a
  90. space on each side of the word: " the ".  It is, however, better to not
  91. leave a space on each side of the word, since the program is more
  92. successful without them.  Many word processing programs use control
  93. characters instead of spaces (at times) and this may confuse the search
  94. process.  Control characters are only filtered out for the final
  95. display.  This program is CASE INSENSITIVE.  You may enter any
  96. combination of upper and lower case letters.
  97.  
  98. -12345 denotes the color of the text string output on the screen.
  99.  
  100.            -1 white on black (default)
  101.            -2 green on black
  102.            -3 blue on black
  103.            -4 red on black
  104.            -5 cyan on black
  105.  
  106. Information header and highlighting colors are predetermined.  You do
  107. NOT need ansi.sys for this program.
  108.  
  109. -p pauses the display after every full screen (default: off)
  110.  
  111. -tp is a new parameter.  It pauses the display after every text match.
  112.     The good thing about this parameter is that it allows you to view
  113.     the files that you are scanning.  After you find a text match, the
  114.     display pauses.  The bottom line offers you various choices.  You
  115.     may quit by pressing ESC (you can do this at any time anyway), you
  116.     may scroll forward 5 lines by pressing the space bar (these are 5-
  117.     70 character lines - it allows you to read the text or whatever but
  118.     the display isn't formatted) or scroll backward 5 lines by pressing
  119.     backspace.  You may scroll as many lines as you wish by pushing
  120.     either key.  You may go on to the next match by pressing ENTER.  If
  121.     you have a lot of text matches, the use of this parameter can be
  122.     very time consuming since it pauses after every match.
  123.  
  124.  
  125. -r This parameter is new and causes subdirectories below the specified
  126.    directory to be searched (on any drive).  It can only be used in
  127.    conjunction with wild cards e.g.: c:\dos\*.bas -r searches all files
  128.    with the .BAS extension in the DOS directory and all .BAS files in
  129.    all subdirectories of the DOS directory.  This parameter causes your
  130.    disk to be read and a temporary file is created in the root
  131.    directory on the C drive which means YOU SHOULD ONLY RUN THIS FROM A
  132.    SYSTEM WITH A C DRIVE.  It creates three temporary files:
  133.    DRCT$$$$.DAT, DRCT$$$2.DAT and DRCT$$$3.dat.  These are deleted
  134.    after use but if you experience a power failure or something and you
  135.    see these files in your root directory, you'll know what they are.
  136.    This parameter does not work with or in search files.  -r actually
  137.    creates a temporary "search file" for use by the program.  You can
  138.    create your own "search files" as mentioned previously.
  139.  
  140.  
  141. (/)/d:\xx  You may direct the output to a file if you wish by
  142.            specifying a file on the command line.  You must use the /
  143.            character to do this and the file may be any valid file or
  144.            path.  If the file specified does not exist, it will be
  145.            created.  This program will not create subdirectories.
  146.  
  147.            For use in batch files, the screen display can be turned off
  148.            while directing output to a file by using
  149.            two /'s:   //d:\xx
  150.  
  151.  
  152. EXAMPLES:
  153.  
  154.            SRCH104 c:\fileman "crazy" -2 -p /d:\hold
  155.  
  156.   This example searches the file "fileman" in the root
  157.   directory for the word fragment "crazy".  The results will
  158.   be outputted to the screen in green on black and the screen will
  159.   pause after each full screen (if the display is long enough).  The
  160.   output will also be directed to the "hold" file on the D drive.
  161.  
  162.  
  163.           SRCH104 c:\hold\bag " green " //c:\xx
  164.  
  165.   This example searches the "bag" file in the "hold" directory for the
  166.   whole word "green".  The display will be turned off and the output
  167.   will be directed to the "xx" file in the root directory.
  168.  
  169.  
  170.            SRCH104 b:\*.* "Micro" -5 -p
  171.  
  172.   This example searches all files in the root directory on the B drive
  173.   for the word fragment "Micro".  The text string output will be in
  174.   cyan on black and the screen will pause after each full screen (if
  175.   the display is long enough).
  176.  
  177.  
  178.            SRCH104 -c:\search.dat "Chevy" -2 /d:\utility
  179.  
  180.   This example uses the information in the file search.dat to determine
  181.   which files and directories will be searched for the text string
  182.   "Chevy".  The text string output will be green on black and will also
  183.   be directed to the file "utility" on the D drive.
  184.  
  185.  
  186.            SRCH104 C:\*.* -r "formula" -5 -tp
  187.  
  188.  
  189.   This example scans every file in every directory on your disk and
  190.   pauses after every match on the text fragment "formula".  The
  191.   displayed lines will be in cyan.
  192.  
  193.  
  194. Although FILENAME must come after SRCH104 on the command line (and have
  195. a space on each side), the other parameters can actually be put in any
  196. order (and have spaces around them).
  197.  
  198.  
  199. As mentioned earlier, the header colors are predetermined and the
  200. highlighted text will appear in bright yellow.  You may choose the
  201. colors of the displayed lines, however.
  202.  
  203. A help screen will come into view if you enter SRCH104 on the command
  204. line by itself.
  205.  
  206.  
  207.               ---------------------------------
  208.  
  209.                        SRCH104P.EXE
  210.  
  211.                     APPLICATION PROGRAM
  212.  
  213.  
  214. To start this program, enter the directory which contains SRCH104P.EXE,
  215. type in SRCH104P on the command line and press ENTER.  This will bring
  216. up the main screen.  This program operates basically the same as the
  217. command line utility.
  218.  
  219.  
  220. TEXT TO SEARCH FOR
  221. You may access a help menu by typing in ? in this first category and
  222. pressing Enter.  You may select display line colors by typing in /c and
  223. pressing enter.  This program searches only for word fragments and
  224. strips the spaces off any text entered at the prompt.
  225.  
  226.  
  227. PAUSE MODE
  228. This is the same as the command line utility except that you enter p
  229. for pause-page and t (same as -tp for srch104.exe command line utility)
  230. for text-match.  No entry or N will result in no pause at all.  (See
  231. previous section on SRCH104.exe for information on the new text-pause
  232. mode)  YOU MUST NOT DELIMIT THESE PARAMETERS WITH A "-" OR "/" in this
  233. program.
  234.  
  235. PLACE TO SEARCH
  236. You must enter a full path in this category including drive and
  237. directory, e.g.: b:\hold\*.*.  WILDCARDS ARE ALLOWED.  You may search
  238. one file in particular or an entire directory.
  239.  
  240. You may use the /r switch to recurse the specified directory and all
  241. subdirectories under it.  You must use this parameter with wild cards
  242. in the specified file otherwise it will not work.  EXAMPLE:
  243. c:\holding\*.bas /r searches all ".bas" files in the "holding"
  244. directory and all ".bas" files in all subdirectories of "c:\holding".
  245. Use of /r by itself on the entry line will result in an error.
  246. EXAMPLE: c:\*.* /r searches every file in every directory on the C
  247. drive.  SINCE THIS PARAMETER CREATES TEMPORARY FILES ON THE C DRIVE,
  248. YOU MUST ONLY USE IT WITH A SYSTEM WHICH CONTAINS A "C" DRIVE.  Please
  249. see previous section on SRCH104.exe for more information on this
  250. parameter.
  251.  
  252. You may also specify a search file in this category.  You must delimit
  253. it with a hyphen then specify the full path of the search file. EXAMPLE
  254. -d:\srch.dat uses the file srch.dat on the D drive.  Please read about
  255. search files in the previous sections.  The /r parameter does not work
  256. with or in search files.
  257.  
  258.  
  259. COPY FILE
  260. You may specify the full path of a copy file in this category.  If the
  261. file does not exist, it will be created.  This program will not create
  262. subdirectories however.  All output will not only be directed to the
  263. screen but it will also be appended to this file.
  264.  
  265.  
  266.                  -----------------------------
  267.  
  268.  
  269.  
  270.                              MEMORY
  271.  
  272.  Both of these programs should have a minimum of 200K to run otherwise
  273.  it may not function properly or, if you are using the R parameter, it
  274.  may only create temporary files on your disk and then quit.
  275.  
  276.  
  277.                              DESQview
  278.  
  279.  
  280.  These programs work fine under DESQview and should have (at least)
  281.  200k windows in which to run. The following settings work fine:
  282.  
  283.                      Writes directly to the screen   N or Y
  284.                      Displays graphics information   N
  285.                      Virtualize text/graphics        N or Y
  286.                      Uses it own colors              Y
  287.                      Close on Exit                   blank
  288.                      Allow close window command      N
  289.  
  290.  
  291.    You may wish to experiment with your own system in order to
  292.    determine the best settings.
  293.  
  294.  
  295.                    -------------------------------
  296.  
  297.                            LIMITATIONS
  298.  
  299. This program may not be successful for text string searches in
  300. compressed or archived files (.zip, .arc, etc.) since those files use
  301. various forms of character encoding and substitution to achieve their
  302. goal.
  303.  
  304. As with most memory intensive programs, SRCH104 may run up to 30%
  305. slower under DESQview.
  306.  
  307. SINCE THE "R" PARAMETER MAKES TEMPORARY FILES ON THE "C" DRIVE, YOU
  308. SHOULD ONLY USE THIS PARAMETER ON A SYSTEM WHICH HAS A "C" DRIVE.
  309.  
  310.  
  311.  
  312.                   ----------------------------------
  313.  
  314.  
  315.  
  316. FORMATTING INFORMATION (FOR SRCH104.EXE) CAN BE OBTAINED BY TYPING
  317. SRCH104 AT THE PROMPT.
  318.  
  319.  
  320. YOU SHOULD PLACE SRCH104.EXE IN A DIRECTORY WHICH IS CONTAINED IN YOUR
  321. AUTOEXEC.BAT "PATH" STATEMENT.
  322.  
  323.  
  324.  
  325. There aren't many text-searching utilities on the shareware/freeware
  326. market and most of them aren't very versatile and are hard to use and
  327. understand.  These utilities are very easy to use and are very
  328. accurate.
  329.  
  330. You may use this utility for 30 days.  If you like it, I would
  331. appreciate your comments.  If you intend to use this utility, please
  332. register and support shareware by sending $10 to the address listed
  333. below.  Please send along your name and address.  You will receive a
  334. disk (please specify), registration number, and MY GRATITUDE.
  335.  
  336.  
  337.  
  338.  
  339. MILES PAWSKI
  340. MILES PAWSKI & COMPANY
  341. P.O. BOX 170448
  342. SAN FRANCISCO, CA.  94117
  343.  
  344. COMPUSERVE# 70473,527
  345.